Chip: Internet/Chip Internet.iso/viewer/emtex.ins/dvineclq/dviproc.zoo/pctex/dvihgc.doc

Text File | 1990-04-17 | 19KB | 465 lines

                                 DVIVGA
                                 DVIHGC


               Public Domain DVI Previewer for the IBM PC



                              Doug McDonald
         <[e-mail]> | <[e-mail]>

                           Martin Bauchrowitz
                          Stuttgart - W.Germany

                           Stefan A. M\"uhlenweg
                         <[e-mail]>


 DVIxxx is a TeX screen previewer for the IBM PC. It expects the name of
 the .DVI file on the command line, and the extension .dvi can always
 be omitted.  As illustrated below, it issues a one-line identifier
 message and, if no command line arguments are given, type a UNIX-style
 message.

 This driver and the associated font files are public domain. It is part
 of a family written by Nelson Beebe of the University of Utah and
 others. The screen previewer is an adaptation of this code by Doug
 McDonald at the University of Illinois.
 DVIHGC and DVIHGCMS is an adaption of this code by Martin Bauchrowitz.


 EQUIPMENT REQUIREMENTS

 An IBM PC computer with 512K or more of memory. Alternately, a
 compatible with similar specs. The DVIVGA screen driver needs an EGA,
 VGA or MCGA graphics adapter, or a clone. DVIHGC screen driver needs
 only an HGC grapics adapter. A clock speed of 8MHz minimum is
 essentially necessary, unless you are a very patient person.
 A 20 or 25MHz machine is fast enough that you will be very happy.
 A fast hard disk is also necessary.

 DVIVGA will work on computers with EGAs. However, and it is a big however,
 the pixels on an EGA are not square. Hence the output will be distorted:
 circles come out as vertically stretched ellipses, squares as vertically
 stretched rectangles, and text is a bit too high.
 Nevertheless, it doesn't look bad at all and is useful.
 For HGC-Screens, that's the same however.


 OPTIONS

 The order of command options and .DVI file name is not significant; all
 switch values are accepted by this driver, but not all are really
 meaningful.

 Letter case is ignored in option switches:  -A and -a are equivalent.

                -a Implement virtual font caching. This option is
                   essentially useless for this driver.

                -d Produce debugging output on stderr if a non-zero
                   value is given.  These are:

                     2 --- Display coordinates, metrics, and bitmap
                           of each character.
                     8 --- Display each successful file opening.
                    16 --- Display each unsuccessful file opening.
                    32 --- Show discarded off-page text.
                    64 --- Trace virtual font caching.
                   128 --- Trace character setting.

                   It is possible to combine these options by adding
                   their values.

                   CAUTION: DVIHGC has its own graphic routine. But
                   ======== there is no function implemented that allow
                            to see text in graphic mode!!!!
                            You will see only some flimmering lines.

                            If you're using the -d option with DVIHGC,
                            please use the -q option too, so DVIHGC will
                            toggle between text and graphics mode.

       -eVAR=value Define environment variables on command line. This
                   is an alternative to placing them in the DOS
                   environment.


     -ffontsubfile Define an alternate font substitution file which is
                   to be used instead of the default ones (see below).

                -l Inhibit logging.

                -m Reset magnification. The default for the screen
                   driver is -m500 (100dpi). Other values will be reset to
                   the nearest value in this set. Magnification values less
                   than 25 are taken to be a TeX magstep parameter
                   which is applied to the standard magnification for
                   that device. Thus -m-0.5 will reduce the output size
                   by the square root of 1.2, -m2 will increase it by
                   a factor of 1.44.

                   You may well need to use this parameter frequently;
                   good values to try are 600, 548, 456, 417, 380,
                   347, 319, and 289. These are equivalent to -m1,
                   -m0.5, -m-0.5, ... -m-3. -m380 or -m-1.5 gives actual
                   size output using VGA on an IBM8513 monitor.

                   Read about "Batch Files" to find an easy way of
                   changing sizes.


                -q Quiet mode.  Status displays to screen are
                   suppressed, unless warning or error messages are
                   issued.  This switch is a toggle. The default is
                   not to display messages.

                   CAUTION: DVIHGC, if you're using the -q option, the
                   ========         screen toggles between text and graphic
                                    mode.

          -x#units The -x options specify the left margin of the TeX
                   page on the output page in any of several units.
                   Letter case is not significant in the units field,
                   which must not be separated from the number by any
                   space.  The number may be fractional.  For example,
                   -x1.0in, -x2.54cm, -x72.27pt, and -x6.0225pc all
                   specify a one-inch left margin. Negative values are
                   permissible, and may be used to shift the output
                   page left (possibly truncating it on the left) in
                   order to display a wide TeX page.

                   The units field is mandatory, and may be one of

                           big point (1in = 72bp)
                           cicero (1cc = 12dd)
                           centimeter (1in = 2.54cm)
                           didot point (1157dd = 1238pt)
                           inch
                           millimeter (10mm = 1cm)
                           pica (1pc = 12pt)
                           point (72.27pt = 1in)
                           scaled point (65536sp = 1pt)

          -y#units This is just like -x except that it is for the top
                   margin.

                   Because the normal defaults waste screen space, the
                   defaults for the screen driver have both been set to
                   zero. If you wish to get the correct margins and
                   size, try -x1.in -y1.in -m382 for DVIVGA.



 FONT SUBSTITUTION

 If no -ffontsubfile option is given, and font substitution is required,
 if the current .DVI file is  foo.dvi, then the files  foo.sub,
 texfonts.sub, and TEXINPUTS\texfonts.sub will be tried in order.  The
 first two will be found on the current directory, and the last is the
 default given in the environment string TEXINPUTS.  The -f option
 allows all of these to be overridden. It is essentially necessary to
 have this file if you use a magnification smaller than the default for
 DVIVGA. A copy of a suitable one is supplied.

 Font substitution lines have the form:


             oldname.oldmag      subname.submag   % comment
             oldname oldmag      subname submag   % comment
             oldname             subname          % comment

 Examples are:

----------

 % These provide replacements for some LaTeX invisible fonts:
 icmr10 1500     ->      cmr10 1500      % comment
 icmr10.1500     ->      cmr10.1500      % comment
 icmssb8         ->      cmssb8          % comment

----------


 The first two forms request substitution of a particular font and
 magnification. The third form substitutes an entire font family; the
 closest available magnification to the required one will be used.  Any
 dots in the non-comment portion will be converted to spaces, and
 therefore, cannot be part of a name field.

 The first matching substitution will be selected, so
 magnification-specific substitutions should be given first, before
 family substitutions.

 Comments are introduced by percent and continue to end-of-line, just as
 for TeX. One whitespace character is equivalent to any amount of
 whitespace. Whitespace and comments are optional.



 SCREEN CONTROL

 DVIxxx supports interactive viewing of the TeX output. Here is the
 current command list. Input is immediate; no terminating carriage
 return is necessary, except for the number command to go to a
 particular page.

 uparrow downarrow Move the view of the current page up or down. These
                   commands do not require recalculating the screen
                   image and are very fast.

                 D Move the page origin one inch down.

                 d Move the page origin one-quarter inch down.

                 U Move the page origin one inch up.

                 u Move the page origin one-quarter inch up.

                 L Move the page origin one inch left.

    leftarrow or l Move the page origin one-quarter inch right.

                 R Move the page origin one inch right.

   rightarrow or r Move the page origin one-quarter inch right.
                   "Inches" refers to the "printed" page, and is only
                   approximate on the screen.

   CARRIAGE RETURN see the next page in the document.

           PG-DOWN see the next page in the document.

           PG-  UP see the prev page in the document.

              HOME see the first page in the document.

               END see the last page in the document.

     every number,
       followed by
   CARRIAGE RETURN see the #th page in the document.

     every number,
       followed by
               ESC makes nothing.

                 Q (or q or X or x or Ctrl-Break or Ctrl-C or Ctrl-Y or ESC)
                   Quit or exit.  The screen will be cleared and restored to
                   its normal mode.

                 B Zoom up one magstep (1.2 times larger) from current
                   size.

                 b Zoom up 1/2 magstep (1.09 times larger) from
                   current size.

                 S Zoom down one magstep (1.2 times smaller) from
                   current size.

                 s Zoom down 1/2 magstep (1.09 times smaller) from
                   current size.

                   How well these zoom options work depends on how many
                   fonts you have loaded: more is better.

                   The command sequence RDsS will result in a display of
                   approximately the same size and origin as a printed
                   page if your physical display is the same size as
                   the IBM 8513, and you start at the normal defaults.



 SPECIALS

 The TeX \special command is intended to allow the specification in a
 .tex file of a request to the .DVI driver, usually for the insertion
 of graphical material at that point in the document.  It is not
 implemented for the DVIVGA/DVIHGC driver.


 BATCH FILES

 If you need to use other than the default size a lot, for instance if
 your text is wider than 5.6 inches, you can make this convenient by
 using a batch file. For example, make a batch file, say DVIWIDE.BAT
 containing the line

                   dvixxx -m417 -x2.0cm -y1.5cm %1

 and nothing else. Then if you say "DVIWIDE filename" you will get your
 6.5 inch wide file to fit on the page. You can of course adjust these
 numbers for your own favorite text shape, and can change other things
 as well.


 ENVIRONMENT VARIABLES

 The behaviour of the .DVI translators can be influenced by definition
 of logical names under PC-DOS.  Compiled-in internal defaults will be
 provided for any of these which are not defined.   They should be
 entirely in upper case. You may need so many environment strings that
 you will have to expand the DOS environment area, maybe as big as 1000
 bytes. I am assuming that you have more than one hard disk: if
 you have only one, change d: to c:. In that case, PCTeX won't need
 to use environment variables.

 The names currently recognized are as follows:

    FONTLIST  Normally, the drivers are prepared to search first for
              .pk, then  .gf, then .pxl font files. This variable can
              be used to change this search order, or remove one or
              more of the possibilities.  It is expected to contain at
              least one of the strings  PK,  GF, or PXL, possibly
              separated by arbitrary punctuation and other text. Letter
              case is not significant.    Some acceptable strings are
              PXL-then-PK-then-GF,  pk.gf,  use-only-PXL-fonts, and
              PXL/GF/PK. For the fonts provided with this product, use
              "set FONTLIST=pk".

    TEXFONTS  This defines the directory path for finding font files.
              Its value is  prepended to the name of a  font to get a
              full file specification.  A typical value for TEXFONTS
              would be d:\pctex\texfonts\. Some people using PCTeX
              might prefer d:\pctex\pixel\.

    TEXINPUTS This defines the directory path for finding files which
              are not in the current working directory. It is
              prepended to file names. A typical value for TEXINPUTS
              would be d:\pctex\texinput\

    DVISCR    !!! DVIVGA only !!!
              This variable allows specification of a particular video
              mode, independent of the automatically assumed one.
              Meaningful values are:

              set DVISCR=EGAM        ega mono screen
              set DVISCR=EGAC        ega color screen
              set DVISCR=VGAM        vga mono screen
              set DVISCR=VGAC        vga color screen

 The purpose of this is normally to allow running DVIVGA under
 alternative "environments". In particular, under Microsoft Windows
 386, setting DVISCR=EGAC or EGAM will allow you to run DVIVGA in a
 window if you have a VGA, using the Windows 386 420 line driver. Doing
 this will allow looking at screen output simultaneously with looking
 at your .tex file in an editor like Windows Write or Notepad.

 Getting both PC-TeX and these drivers to work at the same time
 requires lots of environment variables.
 One set that works for me is:

     set TEXFMTS=d:\pctex\texfmts
     set TEXINPUTS=d:\pctex\texinput\
     set TEXFONTS=d:\pctex\texfonts\   (see section below)
     set FONTLIST=PK

 where you will note that the ones for the device drivers end in "\"
 while the ones for PC-TeX itself don't. You might also need:

      set TEXINPUT=d:\pctex\texinput
      set TEXTFMS=d:\pctex\textfms

 You could get away without expanding your environment by using a
 configuration file for PC-TeX, putting it on the PC-TeX command line,
 by omitting FONTLIST (which at worst would slow things down a bit),
 and by putting the fonts in a directory with a shorter pathname. You
 could get rid of TEXINPUTS entirely by putting a copy of texfonts.sub
 in your current directory. Again, if you have only one hard disk,
 PCTeX probably won't need TEXFMTS, TEXINPUT, and TEXTFMS.



 DIRECTORY STRUCTURE FOR FONTS

 The fonts have to be placed in a proper manner. Assuming you set, as I
 do, TEXFONTS to d:\pctex\texfonts\, you need to place all the fonts
 for size 100 in directory d:\pctex\texfonts\100, those for size 121 in
 d:\pctex\texfonts\121, etc. Note that this implies that you will have
 a lot of subdirectories with names that are numbers. These numbers
 are dot per inch values, and are 1/5 the "magnification value" used
 with the "m" command line parameter. It is traditional to put .pk
 and .gf fonts in directories numbered like that. Pixel (.pxl) files
 are, on the other hand, placed in directories with the magnification
 value in their name. Thus \100\cmr10.pk and \502\cmr10.pxl are likely
 the same font. It appears that PcTeX uses .pxl files a lot for their
 drivers. DVIVGA will use those if they are in the size series it expects.
 Having .pk and .pxl files in the same directory structure PROBABLY
 won't hurt, though it has not been tested. There is nothing magic
 about these directory names - if you like \pixel\ instead of \texfonts\,
 perhaps because it is already there, use it instead.


 BUGS

 None presently known, (See LIMITATIONS and EQUIPMENT REQUIREMENTS)

 Certain "clone" computers may have problems with floating point math.
 If the program behaves oddly, try running with the -q flag. If you get
 odd error messages with such phrases as "math" or "floating point"
 in them, try adding the string "set NO87=no-80x87-available"
 in you environment along with all the other strings. Sometimes
 this might make it work. This appears to be a bug the the cloning
 process, not this program.



 LIMITATIONS

 It is limited in the number of fonts they can access. It is vitally
 important that you put "FILES=20" or more in your config.sys file. If
 you don't, you can get tied up in (almost) infinite searches for files
 which can never be loaded. Under optimum circumstances, at least 35
 fonts can be used in a document, even on one page. This is for a 640K
 computer.




Bugs in either the software or its documentation
should be reported by electronic or postal mail to

    Stefan A. M\"uhlenweg
    Institut f\"ur Meereskunde der Universit\"at Hamburg
    Troplowitzstr. 7
    D-2000 Hamburg 54
    West-Germany

    Tel. [phone]
    EMAIL: [e-mail]

or to

    Martin Bauchrowitz
    Breslauerstr. 9
    D-7257 Ditzingen
    West-Germany

    Tel. [phone]

or to

    Doug McDonald

    EMAIL:
    [e-mail]   (Bitnet)
    [e-mail] (Internet)

or to

    Nelson H.F. Beebe
    Center for Scientific Computation
    220 South Physics Building
    University of Utah
    Salt Lake City, UT 84112
    USA

    Tel: USA [phone]
    EMAIL: [e-mail] (Internet)